[Refactor]: Stagehand MCP becoming the Browserbase MCP #89

Kylejeong2 · 2025-06-22T22:14:02Z

What

Switching the Browserbase MCP to be purely stagehand based.

To be hosted at mcp.browserbase.com/mcp and by smitihery.

Stagehand Primitives as tool calls + new tools to run stagehand sessions in parallel.

…and init issues fixed

…tom models in config, session manager migrated to only use stagehand, rm browserbase SDK, remove unnecessary functions

…ics + multi-sessions update in readme

… uses datenow for extra uniqueness

* fix session url bugs * readme small updates + add github workflows to publish + ci

…ession create

Copilot

Pull Request Overview

This PR refactors the MCP server by removing the old Stagehand-only implementation and introducing a unified Browserbase MCP powered by Stagehand.

Fully deletes the stagehand directory (old MCP implementation).
Adds a new TypeScript-based src/ directory with updated tool definitions, server setup, and CLI.
Updates branding to “Browserbase MCP” across resources, prompts, and documentation.

Reviewed Changes

Copilot reviewed 66 out of 77 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
stagehand/src/tools.ts	Removed old Stagehand tool definitions.
stagehand/src/server.ts	Removed legacy Stagehand MCP server logic.
src/utils.ts	Updated `sanitizeMessage` signature and added `sanitizeForFilePath`.
src/tools/index.ts	Newly exports Browserbase Stagehand tools and multi-session tools.
src/index.ts	Main MCP server entrypoint using Browserbase and Stagehand.
src/program.ts	CLI program to start the new MCP server via Stdio or HTTP transports.

Files not reviewed (2)

browserbase/package-lock.json: Language not supported
stagehand/package-lock.json: Language not supported

src/tools/navigate.ts

greptile-apps

PR Summary

Major architectural overhaul replacing the Browserbase MCP implementation with a pure Stagehand-based system, streamlining browser automation capabilities and modernizing the codebase.

Consolidated server architecture by moving from browserbase/ and stagehand/ directories to a unified src/ structure with improved MCP tools (src/tools/*)
Added robust multi-session support in src/tools/multiSession.ts enabling parallel browser automation with session-aware tools
Implemented new model integration system in src/mcp/sampling.ts for LLM-powered browser automation with pre-built templates
Enhanced type safety across the codebase with Zod schema validation and strict TypeScript types in src/types/types.ts
Added new CI/CD pipelines with Node.js 22 in .github/workflows/, noting potential timing considerations for LTS status

_{💡 (3/5) Reply to the bot's comments like "Can you suggest a fix for this @greptileai?" or ask follow-up questions!}

_{72 files reviewed, 18 comments}
_{Edit PR Review Bot Settings | Greptile}

tsconfig.json

src/mcp/prompts.ts

src/tools/tool.ts

package.json

src/config.ts

src/stagehandStore.ts

src/tools/session.ts

src/stagehandStore.ts

src/tools/session.ts

greptile-apps

PR Summary

Recent changes focus on package management modernization and session handling improvements while completing the Stagehand integration.

Migrated to pnpm with new workspace configuration, strict engine requirements, and updated CI/CD workflows
Enhanced session cleanup with proper disconnect event handling and memory leak prevention in src/stagehandStore.ts
Simplified configuration system in src/config.ts by removing filesystem operations, defaulting to 'google/gemini-2.0-flash' model
Removed src/utils.ts and redundant prompts like click_search_button as functionality moves to Stagehand core
Added comprehensive documentation in README.md for model configurations (Gemini, GPT-4, Claude) and multi-session capabilities

_{12 files reviewed, 2 comments}
_{Edit PR Review Bot Settings | Greptile}

.npmrc

.github/workflows/ci.yml

…tion in config

greptile-apps

PR Summary

Major transport layer overhaul focusing on streamable HTTP and enhanced configuration management for the Stagehand-based MCP server.

Removed SSE transport in favor of streamable HTTP transport in src/transport.ts, consolidating all traffic through /mcp endpoint
Added comprehensive Gemini API key validation with helpful error messaging in src/config.ts
Introduced multi-stage Dockerfile optimization using node:lts-alpine, reducing final image size
Added robust async session cleanup with graceful browser closure in src/sessionManager.ts

_{13 files reviewed, 5 comments}
_{Edit PR Review Bot Settings | Greptile}

src/program.ts

config.d.ts

Dockerfile

config.d.ts

Dockerfile

…tting

Kylejeong2 added 6 commits June 25, 2025 16:11

stagehand migration v1

2f58ed3

stagehand tools using browser context similar to browserbase + stageh…

e9e1e78

…and init issues fixed

rm legacy tool call and separate tools into individual files

022b65a

clean up readonly functions

e1c8f80

cleanup tools

e2431ed

remove unnecessary logger, updated readme, converted to smithery, cus…

c5a8d66

…tom models in config, session manager migrated to only use stagehand, rm browserbase SDK, remove unnecessary functions

Kylejeong2 force-pushed the kj/stagehand branch from e50969b to c5a8d66 Compare June 26, 2025 00:47

Kylejeong2 and others added 11 commits June 25, 2025 18:01

migration to just one mcp server in the repo + readme updates

352b9c2

change to structured extract, better prompts for tools

f1d7dec

better extract + update tool names + add pnpm prettier lint

91e313f

v0 multi-session tools

f32fd05

add husky for commits + pnpm exec husky init + move around mcp specif…

a0204a5

…ics + multi-sessions update in readme

prettier-fix

98f4cb0

better husky script, multisession prompting updates + stagehand store…

ff674aa

… uses datenow for extra uniqueness

zod fix

9c4a533

add deps

70d99c4

[Fix]: add workflows to publish to npm + bug fixes (#93)

95834ab

* fix session url bugs * readme small updates + add github workflows to publish + ci

rename session list to multi session, added better prompting

a4d74f6

Kylejeong2 force-pushed the kj/stagehand branch from 9a28403 to a4d74f6 Compare July 1, 2025 21:54

Kylejeong2 added 2 commits July 1, 2025 16:41

add modelapikey to config

d6fb91d

moving types around, removing unnecessary code, reworking stagehand s…

d81dcc8

…ession create

Kylejeong2 requested a review from Copilot July 3, 2025 06:14

Copilot AI reviewed Jul 3, 2025

View reviewed changes

src/tools/navigate.ts Outdated Show resolved Hide resolved

typo in navigate tool

64d70df

greptile-apps bot reviewed Jul 3, 2025

View reviewed changes

fix potential mem leak, pnpm, prompts session typeof

763acaf

greptile-apps bot reviewed Jul 3, 2025

View reviewed changes

.npmrc Outdated Show resolved Hide resolved

.github/workflows/ci.yml Outdated Show resolved Hide resolved

Kylejeong2 added 2 commits July 3, 2025 12:20

pnpm fix ci, screenshot unique, transport validation, formatting

73b205d

fix pnpm versioning in ci

8c485a3

Kylejeong2 marked this pull request as ready for review July 3, 2025 20:41

Kylejeong2 added 2 commits July 3, 2025 16:23

console errors if user runs stdio with no api key + gemini key valida…

398101a

…tion in config

smithery cli tools

774c6d0

smithery-ai bot had a problem deploying to production July 4, 2025 00:38 Failure

smithery-ai bot had a problem deploying to production July 4, 2025 00:43 Failure

smithery-ai bot had a problem deploying to production July 4, 2025 00:44 Failure

smithery yaml fix + smithery cli

5fd6b2f

smithery-ai bot had a problem deploying to production July 4, 2025 01:10 Failure

rm sse + dockerfile update to support pnpm

b6e7dd1

smithery-ai bot had a problem deploying to production July 4, 2025 03:49 Failure

dockerfile

85d9e96

smithery-ai bot had a problem deploying to production July 4, 2025 04:43 Failure

switch to container deploy

0026ccc

smithery-ai bot had a problem deploying to production July 4, 2025 04:52 Failure

smithery-ai bot had a problem deploying to production July 4, 2025 22:41 Failure

adjusting dockerfile and config imports

156fd63

smithery-ai bot temporarily deployed to production July 5, 2025 00:39 Inactive

smithery yaml update

f7f4885

smithery-ai bot temporarily deployed to production July 5, 2025 01:01 Inactive

await session cleanup

970dc55

smithery-ai bot had a problem deploying to production July 6, 2025 06:55 Failure

lazy loading of keys

c1059d1

smithery-ai bot had a problem deploying to production July 7, 2025 03:33 Failure

smithery-ai bot had a problem deploying to production July 7, 2025 03:36 Failure

rm unused deps:

68b2ebf

smithery-ai bot temporarily deployed to production July 7, 2025 03:42 Inactive

greptile-apps bot reviewed Jul 7, 2025

View reviewed changes

src/program.ts Outdated Show resolved Hide resolved

config.d.ts Outdated Show resolved Hide resolved

Dockerfile Show resolved Hide resolved

config.d.ts Outdated Show resolved Hide resolved

Dockerfile Outdated Show resolved Hide resolved

race condition in cleanup + better JSDoc in config + dockerfile forma…

927db9b

…tting

smithery-ai bot deployed to production July 7, 2025 04:23 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[Refactor]: Stagehand MCP becoming the Browserbase MCP #89

[Refactor]: Stagehand MCP becoming the Browserbase MCP #89

Kylejeong2 commented Jun 22, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

[Refactor]: Stagehand MCP becoming the Browserbase MCP #89

Are you sure you want to change the base?

[Refactor]: Stagehand MCP becoming the Browserbase MCP #89

Conversation

Kylejeong2 commented Jun 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

PR Summary

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

PR Summary

Uh oh!

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

PR Summary

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Kylejeong2 commented Jun 22, 2025 •

edited

Loading